---
title: PdfAPI.Client
summary: Entry point for the PdfAPI.Client API client package documentation.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-09-17
---

# PdfAPI.Client

`PdfAPI.Client` is a hand-written .NET Framework 4.6.2 NuGet client that wraps five endpoints of the `PdfAPI` REST API (conversion, merge, PDF/A validation, and tracking-status lookup) and also ships six purely local, in-process PDF operations backed by the shared `PdfAPI.Core` contracts assembly. It is packaged and released alongside the API it wraps, from the same repository.

| Field | Value |
| --- | --- |
| **Package id** | `PdfAPI.Client` |
| **Assembly** | `PdfAPI.Client.dll` |
| **Framework** | .NET Framework v4.6.2 (`lib\net45`) |
| **Client class** | `PdfAPI.Client.PdfClient` : `PdfAPI.Client.IPdfClient` |
| **HTTP surface** | `SAIF.Web.API.Clients.JsonHttpClient` |
| **Wrapped API** | `PdfAPI` |
| **Shared contracts** | `PdfAPI.Core` |

<!-- The output root is docs/clients/pdfapi-client/ even though PdfAPI.Client ships from the same
     repository as the PdfAPI it wraps. The reader's path must never depend on repository layout. -->

## Documentation sections

| Section | Description |
| --- | --- |
| [Overview](overview.md) | What the client wraps, who consumes it, and capability summary |
| [Architecture](architecture.md) | Internal structure, `JsonHttpClient` wrapping, and construction |
| [Package](package.md) | nuspec identity, version, dependencies, shipped content, feed, and pipeline |
| [Client reference](reference.md) | One section per public member of the client interface (11 members) |
| [Endpoint map](endpoint-map.md) | Client method → API endpoint traceability |
| [Consumption](consumption.md) | How a consumer constructs and calls the client |
| [Contracts](contracts.md) | The shared `PdfAPI.Core` DTO assembly |
| [Dependencies](dependencies.md) | Packages, framework components, and the wrapped API |
| [Business rules](business-rules.md) | Rules enforced client-side before or after the call |
| [Tech debt](tech-debt.md) | CRITICAL and HIGH severity findings |

## Wrapped API

| Attribute | Value |
| --- | --- |
| API name | `PdfAPI` |
| Documented by this run | Yes |
| API documentation | [PdfAPI](../../apis/pdfapi/index.md) |
| Base URI source | Caller-supplied constructor argument (`PdfClient(ClientInfo info, string url)`) |
| Version suffix | `v1/` |

## Related documentation
- [Overview](overview.md)
- [Architecture](architecture.md)
- [Package](package.md)
- [Client reference](reference.md)
- [Endpoint map](endpoint-map.md)
- [Consumption](consumption.md)
- [Contracts](contracts.md)
- [Dependencies](dependencies.md)
- [Business rules](business-rules.md)
- [Tech debt](tech-debt.md)

## Sources
- `PdfAPI.Client\PdfClient.cs`
- `PdfAPI.Client\IPdfClient.cs`
- `PdfAPI.Client\PdfAPI.Client.csproj`
- `Scripts\PdfAPI.Client\PdfAPI.Client.nuspec`